From 3ce7f39b2e6dc3751d8ec45f60d0779519f2210e Mon Sep 17 00:00:00 2001 From: Diego Rodrigues de Sa e Souza <8016841+diegosouzapw@users.noreply.github.com> Date: Mon, 15 Jun 2026 13:16:19 -0300 Subject: [PATCH] docs: regenerate stale counts to canonical (226 providers / 87 MCP tools / 15 strategies / 42 locales) (#3904) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Several docs bodies carried stale counts from the v3.8.0–v3.8.2 era while the code moved on. Brought them to the canonical values verified against source: - providers 177/160+/223 → 226 (docs/reference/PROVIDER_REFERENCE.md "Total providers") - MCP tools 37/42/43 → 87 (open-sse/mcp-server TOTAL_MCP_TOOL_COUNT) - routing strategies 14 → 15 (routingStrategies.ts ROUTING_STRATEGY_VALUES) - i18n locales 40/40+ → 42 (config/i18n.json) - MCP scopes ~13/13 → 30 Files: ARCHITECTURE, CODEBASE_DOCUMENTATION, REPOSITORY_MAP, QUALITY_GATES, ACP, AGENT-SKILLS, AGENTBRIDGE, PROVIDERS-GUIDE, SETUP_GUIDE, MCP-SERVER (headline), OMNIROUTE_VS_ALTERNATIVES, README, RELEASE_CHECKLIST. Executors (60), OAuth providers (16), A2A skills (6) and cloud agents (3) were already correct (check-docs-counts-sync --strict still passes). Left untouched on purpose: the point-in-time reports (DOCUMENTATION_AUDIT_REPORT, E2E shakedown) and the MCP tool inventory diagram (mcp-tools-43.svg) — diagram regeneration is a separate task. This unblocks full GitHub-wiki content parity: the wiki was synced from these corrected sources via scripts/docs/sync-wiki.mjs --update-existing. --- docs/README.md | 4 ++-- docs/architecture/ARCHITECTURE.md | 4 ++-- docs/architecture/CODEBASE_DOCUMENTATION.md | 4 ++-- docs/architecture/QUALITY_GATES.md | 2 +- docs/architecture/REPOSITORY_MAP.md | 10 +++++----- docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md | 6 +++--- docs/frameworks/ACP.md | 2 +- docs/frameworks/AGENT-SKILLS.md | 2 +- docs/frameworks/AGENTBRIDGE.md | 2 +- docs/frameworks/MCP-SERVER.md | 2 +- docs/getting-started/PROVIDERS-GUIDE.md | 2 +- docs/guides/SETUP_GUIDE.md | 2 +- docs/ops/RELEASE_CHECKLIST.md | 2 +- 13 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/README.md b/docs/README.md index 4c85a157a1..745b6be723 100644 --- a/docs/README.md +++ b/docs/README.md @@ -78,7 +78,7 @@ Pluggable subsystems exposed to clients, agents, and operators. Combo routing, scoring, and replay. -- [AUTO-COMBO.md](routing/AUTO-COMBO.md) — Auto-Combo (9-factor scoring, 14 strategies). +- [AUTO-COMBO.md](routing/AUTO-COMBO.md) — Auto-Combo (9-factor scoring, 15 strategies). - [REASONING_REPLAY.md](routing/REASONING_REPLAY.md) — reasoning replay flow. ## security/ @@ -118,7 +118,7 @@ Mermaid sources and exported SVG/PNG diagrams referenced from the docs above. Po ## i18n/ -Translated mirrors of the documentation in 40 locales. See [i18n/README.md](i18n/README.md) for the supported language list. +Translated mirrors of the documentation in 42 locales. See [i18n/README.md](i18n/README.md) for the supported language list. ## screenshots/ diff --git a/docs/architecture/ARCHITECTURE.md b/docs/architecture/ARCHITECTURE.md index 3792dec1ec..d324748a8d 100644 --- a/docs/architecture/ARCHITECTURE.md +++ b/docs/architecture/ARCHITECTURE.md @@ -17,7 +17,7 @@ It provides a single OpenAI-compatible endpoint (`/v1/*`) and routes traffic acr Core capabilities: -- OpenAI-compatible API surface for CLI/tools (177 providers, 60 executors) +- OpenAI-compatible API surface for CLI/tools (226 providers, 60 executors) - Request/response translation across provider formats - Model combo fallback (multi-model sequence) - Structured combo steps (`provider + model + connection`) with runtime ordering by `compositeTiers` @@ -58,7 +58,7 @@ Core capabilities: - 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 (37 tools) with 3 transports (stdio/SSE/Streamable HTTP) +- MCP Server (87 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) diff --git a/docs/architecture/CODEBASE_DOCUMENTATION.md b/docs/architecture/CODEBASE_DOCUMENTATION.md index d222b94b90..8c0b5caa28 100644 --- a/docs/architecture/CODEBASE_DOCUMENTATION.md +++ b/docs/architecture/CODEBASE_DOCUMENTATION.md @@ -457,7 +457,7 @@ open-sse/ ├── 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) +└── mcp-server/ MCP server (3 transports, 30 scopes, 87 tools) ``` ### 4.1 `open-sse/handlers/` @@ -525,7 +525,7 @@ Highlights (full list under `open-sse/services/`): | Concern | Files | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Combo routing | `combo.ts` (14 strategies), `comboConfig.ts`, `comboMetrics.ts`, `comboManifestMetrics.ts`, `comboAgentMiddleware.ts` | +| Combo routing | `combo.ts` (15 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` | diff --git a/docs/architecture/QUALITY_GATES.md b/docs/architecture/QUALITY_GATES.md index d21ce3a4de..0d62acb453 100644 --- a/docs/architecture/QUALITY_GATES.md +++ b/docs/architecture/QUALITY_GATES.md @@ -103,7 +103,7 @@ Runs after `build`. Blocks merge on failure. | Suite | Validates | Blocking | | ---------------- | ------------------------------------------------------- | -------------------------------------------------------------------------- | -| `test:vitest` | MCP server (43 tools), autoCombo, cache — vitest runner | Yes | +| `test:vitest` | MCP server (87 tools), autoCombo, cache — vitest runner | Yes | | `test:vitest:ui` | UI component tests — vitest runner | **Advisory** (`continue-on-error: true`) — failing until Fase 6A UI triage | --- diff --git a/docs/architecture/REPOSITORY_MAP.md b/docs/architecture/REPOSITORY_MAP.md index c533392108..2fb5c24e9e 100644 --- a/docs/architecture/REPOSITORY_MAP.md +++ b/docs/architecture/REPOSITORY_MAP.md @@ -245,7 +245,7 @@ src/ | Module | Purpose | | -------------------------------- | ---------------------------------------------------------------------- | -| `constants/providers.ts` | **177 providers** with Zod validation (source of truth) | +| `constants/providers.ts` | **226 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 | @@ -271,7 +271,7 @@ open-sse/ ├── 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) +├── mcp-server/ # MCP server (87 tools, 3 transports, 30 scopes) ├── config/ # Provider/model registries, header config, model aliases ├── utils/ # TLS client, proxy fetch/dispatcher, network helpers ├── index.ts # Workspace entry @@ -402,13 +402,13 @@ open-sse/ | `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`) | +| `PROVIDER_REFERENCE.md` | **Auto-generated** catalog of 226 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 | +| `MCP-SERVER.md` | MCP server: 87 tools, 3 transports, 30 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 | @@ -452,7 +452,7 @@ open-sse/ | 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/i18n/` | Localized doc translations (~42 locales) | | `docs/screenshots/` | Image assets for guides | | `docs/superpowers/plans/` | Implementation plans (generated by `superpowers:writing-plans` skill) | diff --git a/docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md b/docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md index 4af363c97f..b7d7af4b1e 100644 --- a/docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md +++ b/docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md @@ -16,10 +16,10 @@ Objective feature comparison vs popular open-source AI routers. | **Providers** | **207+** | ~100 | ~50 | ~30 | | **Self-hostable** | ✅ | ✅ | ❌ | ⚠ paid | | **OAuth providers (Claude, Codex, Copilot, etc.)** | **15+** | partial | ❌ | ❌ | -| **Auto-fallback combos** | **14 strategies** | priority-based | tier-based | weighted | +| **Auto-fallback combos** | **15 strategies** | priority-based | tier-based | weighted | | **Tier 1/2/3 fallback (subscription→cheap→free)** | ✅ + UI | manual | n/a | manual | | **Token compression** | RTK (47 filters) + Caveman | none | none | none | -| **Built-in MCP server** | ✅ 37 tools, 13 scopes | ❌ | ❌ | ❌ | +| **Built-in MCP server** | ✅ 87 tools, 30 scopes | ❌ | ❌ | ❌ | | **A2A protocol** | ✅ 5 skills | ❌ | ❌ | ❌ | | **Memory (FTS5 + vector)** | ✅ | ❌ | ❌ | ❌ | | **Guardrails (PII, injection, vision)** | ✅ | partial | ❌ | ✅ paid | @@ -31,7 +31,7 @@ Objective feature comparison vs popular open-source AI routers. | **CLI with system tray (no Electron)** | ✅ | ❌ | n/a | n/a | | **CLI machine-ID auto-auth** | ✅ | ❌ | n/a | n/a | | **Dashboard** | Next.js 16 | basic | proprietary | proprietary | -| **i18n** | **40+ locales** | ❌ | ❌ | ⚠ | +| **i18n** | **42+ locales** | ❌ | ❌ | ⚠ | | **Public agent skills (SKILL.md)** | ✅ 10 | ❌ | ❌ | ❌ | | **Tunnel support (Cloudflared, Tailscale, Ngrok)** | ✅ | ❌ | n/a | n/a | | **License** | MIT | MIT | proprietary | proprietary | diff --git a/docs/frameworks/ACP.md b/docs/frameworks/ACP.md index 1f2b9ab4fe..a33cc4ea85 100644 --- a/docs/frameworks/ACP.md +++ b/docs/frameworks/ACP.md @@ -548,7 +548,7 @@ const agents = detectInstalledAgents(); ## What's Next? - **[API Reference](../reference/API_REFERENCE.md)** — REST API endpoints -- **[Provider Reference](../reference/PROVIDER_REFERENCE.md)** — All 223 providers +- **[Provider Reference](../reference/PROVIDER_REFERENCE.md)** — All 226 providers - **[MCP Server](./MCP-SERVER.md)** — Model Context Protocol integration - **[A2A Server](./A2A-SERVER.md)** — Agent-to-Agent protocol - **[Cloud Agent](./CLOUD_AGENT.md)** — Cloud-based agents diff --git a/docs/frameworks/AGENT-SKILLS.md b/docs/frameworks/AGENT-SKILLS.md index 79d8258eef..ab787b9c62 100644 --- a/docs/frameworks/AGENT-SKILLS.md +++ b/docs/frameworks/AGENT-SKILLS.md @@ -162,7 +162,7 @@ See [A2A-SERVER.md](./A2A-SERVER.md) for protocol details. | `omni-sync-cloud` | sync-cloud | Cloud sync | | `omni-db-backups` | db-backups | Database backups | | `omni-webhooks` | webhooks | Webhook event dispatcher | -| `omni-mcp` | mcp | MCP server (37 tools, 3 transports) | +| `omni-mcp` | mcp | MCP server (87 tools, 3 transports) | | `omni-agents-a2a` | agents-a2a | A2A agent protocol | | `omni-version-manager` | version-manager | Version and update management | | `omni-inference` | inference | Direct inference / completions | diff --git a/docs/frameworks/AGENTBRIDGE.md b/docs/frameworks/AGENTBRIDGE.md index c4656f7bd8..9ad93524fd 100644 --- a/docs/frameworks/AGENTBRIDGE.md +++ b/docs/frameworks/AGENTBRIDGE.md @@ -22,7 +22,7 @@ When an IDE agent (e.g., GitHub Copilot, Cursor, Claude Code) makes an API call, This means you can: -- **Reroute any agent to any provider**: Copilot talking to OpenAI? Redirect it to Anthropic Claude, Gemini, or any of OmniRoute's 160+ providers. +- **Reroute any agent to any provider**: Copilot talking to OpenAI? Redirect it to Anthropic Claude, Gemini, or any of OmniRoute's 226+ providers. - **Apply model mappings**: `gemini-3-flash` → `claude-sonnet-4.7` transparently at the handler level. - **Observe all agent traffic**: every intercepted request is published to the [Traffic Inspector](./TRAFFIC_INSPECTOR.md). - **Apply OmniRoute resilience**: combo routing, circuit breakers, fallbacks, and cost tracking work for IDE agent traffic too. diff --git a/docs/frameworks/MCP-SERVER.md b/docs/frameworks/MCP-SERVER.md index 3e5790fb91..6d78d5e48d 100644 --- a/docs/frameworks/MCP-SERVER.md +++ b/docs/frameworks/MCP-SERVER.md @@ -6,7 +6,7 @@ lastUpdated: 2026-05-30 # OmniRoute MCP Server Documentation -> Model Context Protocol server with 43 tools across routing, cache, compression, memory, skills, proxy, and context source operations. +> Model Context Protocol server with 87 tools across routing, cache, compression, memory, skills, proxy, and context source 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) + `open-sse/mcp-server/tools/notionTools.ts` (6 tools). Tool registration and scope wiring lives in `open-sse/mcp-server/server.ts`. diff --git a/docs/getting-started/PROVIDERS-GUIDE.md b/docs/getting-started/PROVIDERS-GUIDE.md index 1cda76bfca..cfc25ccde7 100644 --- a/docs/getting-started/PROVIDERS-GUIDE.md +++ b/docs/getting-started/PROVIDERS-GUIDE.md @@ -217,4 +217,4 @@ Go to Providers → click on the provider → click **Disconnect**. - **[Auto-Combo Guide](./AUTO-COMBO-GUIDE.md)** — Let OmniRoute pick the best AI for you - **[Free Tiers Guide](./FREE-TIERS-GUIDE.md)** — Get free AI with no credit card - **[Troubleshooting](./TROUBLESHOOTING.md)** — Fix common issues -- **[Provider Reference](../reference/PROVIDER_REFERENCE.md)** — Full list of 177 providers +- **[Provider Reference](../reference/PROVIDER_REFERENCE.md)** — Full list of 226 providers diff --git a/docs/guides/SETUP_GUIDE.md b/docs/guides/SETUP_GUIDE.md index 1946fd8e23..73fe11f0c9 100644 --- a/docs/guides/SETUP_GUIDE.md +++ b/docs/guides/SETUP_GUIDE.md @@ -216,7 +216,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) — 87 tools, IDE configs, Python/TS/Go clients. ### A2A Setup (Agent-to-Agent Protocol) diff --git a/docs/ops/RELEASE_CHECKLIST.md b/docs/ops/RELEASE_CHECKLIST.md index ba50a99cda..e2a2dc3bef 100644 --- a/docs/ops/RELEASE_CHECKLIST.md +++ b/docs/ops/RELEASE_CHECKLIST.md @@ -112,7 +112,7 @@ Breaking changes: add `BREAKING CHANGE:` footer or `!` after the scope (e.g. `fe - [ ] `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 +- [ ] `npm run i18n:sync-ui:dry` reports 0 missing keys across all 42 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)