mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-07-26 09:52:11 +03:00
chore(release): finalize v3.8.8 changelog + add codex-ws dev helper
Update the v3.8.8 changelog (date, Codex Responses-over-WebSocket toggle, Xiaomi MiMo usage tracking, API Manager Normal/Quota sections, MiniMax coding-plan percent fix) and add scripts/codex-ws.sh — a documented wrapper to run the Codex CLI against a local OmniRoute instance.
This commit is contained in:
diegosouzapw
17
CHANGELOG.md
17
CHANGELOG.md
@@ -4,7 +4,7 @@
|
||||
|
||||
---
|
||||
|
||||
## [3.8.8] — 2026-06-01
|
||||
## [3.8.8] — 2026-06-03
|
||||
|
||||
### Added
|
||||
|
||||
@@ -61,6 +61,9 @@
|
||||
- **Dashboard page redesigns (Nav Restructure)** — agent-skills + omni-skills with a dynamic 42-skill catalog and MCP/A2A discovery (#2827); CLI Code's + CLI Agents + ACP Agents pages (#2839); translator friendly redesign, 5 tabs → 2 (#2847); functional `/batch` + `/batch/files` redesign (#2849); Playground Studio + Search Tools Studio (#2869); memory engine redesign — sqlite-vec + hybrid RRF + Studio UI (#2873). (thanks @diegosouzapw)
|
||||
- **notion:** add Notion as an MCP context source — 6 tools (`notion_search`, `notion_list_databases`, `notion_get_database`, `notion_query_database`, `notion_read`, `notion_append_blocks`) scoped under `read:notion` / `write:notion`, with dashboard "Context Sources" tab, settings API, and token persistence in `key_value` table (#2959 — thanks @branben)
|
||||
- **Per-API-key stream default mode** — a per-key setting that forces JSON or SSE as the default response shape (migration `077_api_key_stream_default_mode`), so integrations that expect non-streaming JSON work without client changes. (thanks @JxnLexn)
|
||||
- **Codex Responses-over-WebSocket** — opt-out flag `OMNIROUTE_CODEX_WS_ENABLED` (default ON) upgrading Codex Responses traffic to a WebSocket bridge with a clean handshake and bridge-secret auth; the Quota Share endpoints card now surfaces the Responses + codex-WS endpoints. (thanks @diegosouzapw)
|
||||
- **Xiaomi MiMo usage tracking** — self-reported usage accounting for Xiaomi MiMo plus a monthly cap preset; DeepSeek USD preset and a Claude plan preset (percent 5h + weekly) seeded into the plan registry. (thanks @diegosouzapw)
|
||||
- **API Manager: Normal vs Quota key sections** — the API keys screen now splits keys into Normal and Quota sections in a compact 2-table layout, and the Quota Share screen gains a beta banner, live per-account upstream quota, and a real-time Codex quota view backed by the cascade-safe serialized refresh. (thanks @diegosouzapw)
|
||||
|
||||
### Changed
|
||||
|
||||
@@ -257,10 +260,13 @@
|
||||
- **proxy:** resolve registry proxy assignments for combo and key levels (#3048 — thanks @terence71-glitch)
|
||||
- **providers/web:** wire the session pool for fingerprint rotation on Pollinations / DuckDuckGo (#3049 — thanks @oyi77)
|
||||
- **providers/claude-web:** add `cf_clearance` cookie support and session-pool fingerprint rotation for Pollinations / DuckDuckGo (#3046 — thanks @oyi77)
|
||||
- **usage:** handle MiniMax coding-plan percent quotas (`general`/percent dimension) so MiniMax coding plans report remaining quota correctly. (thanks @diegosouzapw)
|
||||
- **home:** pass `providerId` to the quota widget icons so provider brand icons resolve on the home dashboard (#3064 — thanks @xz-dev)
|
||||
- **quota:** block `qtSd/*` models for keys with no quota-pool allocation (enforcement Check 2.9), and never flag rotating-refresh providers (Codex/OpenAI) as expired during the quota sync (#3030). (thanks @diegosouzapw)
|
||||
|
||||
### 🏆 Contributors
|
||||
|
||||
A special thanks to everyone who contributed to this release — 687 commits since `v3.8.7`:
|
||||
A special thanks to everyone who contributed to this release — 746 commits since `v3.8.7`:
|
||||
|
||||
| Contributor | PRs / Contribution |
|
||||
| --- | --- |
|
||||
@@ -274,7 +280,7 @@ A special thanks to everyone who contributed to this release — 687 commits sin
|
||||
| [@Lion-killer](https://github.com/Lion-killer) | #2981, #2988 |
|
||||
| [@JxnLexn](https://github.com/JxnLexn) | per-API-key stream default mode |
|
||||
| [@androw](https://github.com/androw) | #3017 |
|
||||
| [@xz-dev](https://github.com/xz-dev) | #2975 |
|
||||
| [@xz-dev](https://github.com/xz-dev) | #2975, #3064 |
|
||||
| [@S0yora](https://github.com/S0yora) | #2964 |
|
||||
| [@NekoMonci12](https://github.com/NekoMonci12) | #3008 |
|
||||
| [@Tentoxa](https://github.com/Tentoxa) | #3010 |
|
||||
@@ -284,13 +290,14 @@ A special thanks to everyone who contributed to this release — 687 commits sin
|
||||
| [@dhaern](https://github.com/dhaern) | #2927 |
|
||||
| [@dangeReis](https://github.com/dangeReis) | #3021 |
|
||||
| [@bobbyunknown](https://github.com/bobbyunknown) | #3029 |
|
||||
| [@CitrusIce](https://github.com/CitrusIce) | #3035 |
|
||||
| [@CitrusIce](https://github.com/CitrusIce) | #3035, #3058 |
|
||||
| [@wussh](https://github.com/wussh) | #3036 |
|
||||
| [@Chewji9875](https://github.com/Chewji9875) | #3037 |
|
||||
| [@herjarsa](https://github.com/herjarsa) | #3043 |
|
||||
| [@freefrank](https://github.com/freefrank) | #3066 (reported the Docker build failure) |
|
||||
|
||||
A special thanks to everyone who contributed code, reviews, and tests for this release:
|
||||
@androw, @bobbyunknown, @branben, @charithharshana, @Chewji9875, @CitrusIce, @dangeReis, @dhaern, @diegosouzapw, @guanbear, @herjarsa, @JxnLexn, @Lion-killer, @makcimbx, @NekoMonci12, @NomenAK, @oyi77, @ReqX, @S0yora, @soyelmismo, @Tentoxa, @terence71-glitch, @wussh, @xz-dev
|
||||
@androw, @bobbyunknown, @branben, @charithharshana, @Chewji9875, @CitrusIce, @dangeReis, @dhaern, @diegosouzapw, @freefrank, @guanbear, @herjarsa, @JxnLexn, @Lion-killer, @makcimbx, @NekoMonci12, @NomenAK, @oyi77, @ReqX, @S0yora, @soyelmismo, @Tentoxa, @terence71-glitch, @wussh, @xz-dev
|
||||
|
||||
---
|
||||
|
||||
|
||||
94
scripts/codex-ws.sh
Executable file
94
scripts/codex-ws.sh
Executable file
@@ -0,0 +1,94 @@
|
||||
#!/usr/bin/env bash
|
||||
# =============================================================================
|
||||
# codex-ws — roda a OpenAI Codex CLI contra um OmniRoute LOCAL usando o
|
||||
# transporte Responses-over-WebSocket (em vez do HTTP da Cloud).
|
||||
#
|
||||
# POR QUE ESTE WRAPPER EXISTE
|
||||
# ---------------------------
|
||||
# O OmniRoute expõe um proxy WebSocket para a API de Responses do Codex em
|
||||
# ws(s)://<host>/v1/responses
|
||||
# A Codex CLI sabe falar esse transporte quando o provider tem
|
||||
# `supports_websockets = true` + `wire_api = "responses"`. Mas há DOIS detalhes
|
||||
# que quebram o uso ingênuo:
|
||||
#
|
||||
# 1) A Codex CLI valida o NOME do modelo no cliente. Ids com prefixo de provider
|
||||
# (ex.: "codex/gpt-5.5") são REJEITADOS ("model is not supported ... ChatGPT
|
||||
# account"). É preciso mandar o id "puro" -> "gpt-5.5". (O OmniRoute, no
|
||||
# bridge WS, re-resolve "gpt-5.5" -> provider codex internamente.)
|
||||
#
|
||||
# 2) A Codex CLI v0.136 carrega TAMBÉM "$CWD/.codex/config.toml" como config
|
||||
# "project-local". Se você rodar de um diretório que tenha um .codex (ex.:
|
||||
# /root, onde mora a config da Cloud), o `model` daquele arquivo SOBRESCREVE
|
||||
# o `model` do seu CODEX_HOME -> você acaba mandando o modelo errado.
|
||||
# Por isso forçamos model + model_provider via `-c` (precedência máxima),
|
||||
# que vence qualquer config de arquivo (user-level OU project-local).
|
||||
#
|
||||
# Além disso, no modo `exec` (headless) a CLI exige um diretório "confiável" ou
|
||||
# a flag --skip-git-repo-check; o wrapper adiciona a flag automaticamente.
|
||||
#
|
||||
# USO
|
||||
# ---
|
||||
# codex-ws "sua pergunta" # abre a TUI interativa (precisa de terminal)
|
||||
# codex-ws exec "Responda: PONG" # one-shot headless (CI/validação)
|
||||
# codex-ws --help # repassa flags pra Codex CLI
|
||||
#
|
||||
# Variáveis de ambiente (todas com default; sobrescreva exportando antes):
|
||||
# OMNIROUTE_WS_BASE base URL do OmniRoute local (default abaixo)
|
||||
# OMNIROUTE_WS_MODEL modelo codex (id puro) (default "gpt-5.5")
|
||||
# OMNIROUTE_LOCAL_KEY API key (qualquer valor se REQUIRE_API_KEY=false)
|
||||
# CODEX_WS_HOME dir de config isolado da Codex (default ~/.codex-ws)
|
||||
# =============================================================================
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
# ---- Configuração (com defaults seguros) ------------------------------------
|
||||
OMNIROUTE_WS_BASE="${OMNIROUTE_WS_BASE:-http://127.0.0.1:20128/v1}" # base do OmniRoute local
|
||||
OMNIROUTE_WS_MODEL="${OMNIROUTE_WS_MODEL:-gpt-5.5}" # id PURO (sem "codex/")
|
||||
CODEX_WS_HOME="${CODEX_WS_HOME:-$HOME/.codex-ws}" # CODEX_HOME isolado da Cloud
|
||||
|
||||
# A Codex CLI lê a key Bearer da env var nomeada em `env_key`. Mantemos um nome
|
||||
# próprio para não colidir com OPENAI_API_KEY da config da Cloud.
|
||||
export OMNIROUTE_LOCAL_KEY="${OMNIROUTE_LOCAL_KEY:-local}"
|
||||
|
||||
# CODEX_HOME isolado: a Codex CLI usa ESTE diretório como config "user-level",
|
||||
# deixando a sua ~/.codex (Cloud) totalmente intacta.
|
||||
export CODEX_HOME="$CODEX_WS_HOME"
|
||||
|
||||
# ---- Garante que a config do CODEX_HOME exista (auto-bootstrap) --------------
|
||||
# Só o bloco [model_providers.*] precisa estar aqui; model/model_provider são
|
||||
# forçados via -c logo abaixo (por causa do detalhe #2 do cabeçalho).
|
||||
if [ ! -f "$CODEX_HOME/config.toml" ]; then
|
||||
mkdir -p "$CODEX_HOME"
|
||||
cat > "$CODEX_HOME/config.toml" <<EOF
|
||||
# Gerado por codex-ws.sh — config isolada para o WS local do OmniRoute.
|
||||
model = "$OMNIROUTE_WS_MODEL"
|
||||
model_provider = "omniroute-local"
|
||||
|
||||
[model_providers.omniroute-local]
|
||||
name = "OmniRoute Local (WS)"
|
||||
base_url = "$OMNIROUTE_WS_BASE" # a URL WebSocket é derivada desta base pela CLI
|
||||
wire_api = "responses" # único valor suportado desde fev/2026
|
||||
supports_websockets = true # <- liga o transporte Responses-over-WebSocket
|
||||
env_key = "OMNIROUTE_LOCAL_KEY" # a CLI lê a key Bearer desta env var
|
||||
|
||||
# Marca o HOME como diretório confiável para o modo exec.
|
||||
[projects."$HOME"]
|
||||
trust_level = "trusted"
|
||||
EOF
|
||||
fi
|
||||
|
||||
# ---- Overrides de precedência máxima ----------------------------------------
|
||||
# Vencem qualquer config de arquivo (inclusive a project-local da Cloud em
|
||||
# $CWD/.codex/config.toml). É o que garante o modelo certo no transporte certo.
|
||||
overrides=(-c model="$OMNIROUTE_WS_MODEL" -c model_provider="omniroute-local")
|
||||
|
||||
# ---- Dispatch ---------------------------------------------------------------
|
||||
# No modo headless (`exec`) injeta --skip-git-repo-check (senão a CLI recusa
|
||||
# rodar fora de um repo git "confiável"). O `shift` remove o "exec" duplicado.
|
||||
if [ "${1:-}" = "exec" ]; then
|
||||
shift
|
||||
exec codex exec --skip-git-repo-check "${overrides[@]}" "$@"
|
||||
fi
|
||||
|
||||
# Modo interativo (TUI) ou qualquer outro subcomando/flag: repassa direto.
|
||||
exec codex "${overrides[@]}" "$@"
|
||||
Reference in New Issue
Block a user