v3.5.0 — Major Release: Command Code Multi-Format Parser, AI Assist, Self-Revive Watchdog
CC Adapter (17 fixes): - Multi-format tool-call parser chain: DSML → bash → explore → XML → raw JSON → fallback - Three-tier argument parser (direct/unescape/unicode_escape) - Recursive double/triple-wrap unwrapping (_unwrap_cmd) - Post-extraction sanitizer validation - DSML tag support (current CC model format) - Self-revive watchdog (50 restarts, progressive backoff) - Debug-to-file logging (cc-debug.log) - Inline self-test (19 tests via --self-test) - ErrorAnalyzer with 4xx learning on retry - Schema cache with 24h TTL Launcher: - AI Assist integration - Updated usage dashboard - Reasoning controls per-provider - Updated cleanup patterns .deb: v3.5.0 (70KB) — v3.3.0 kept as fallback
This commit is contained in:
admin
88
README.md
88
README.md
@@ -15,7 +15,7 @@
|
||||
|
||||
<p align="center">
|
||||
<strong>Run OpenAI Codex CLI & Desktop with <em>any</em> AI provider.</strong><br/>
|
||||
Google Antigravity • Gemini CLI • OpenCode • Z.AI • Anthropic • Command Code • OpenRouter • Crof.ai • NVIDIA NIM • Kilo.ai • and more
|
||||
Google Antigravity • Gemini CLI • OpenCode • Z.AI • Anthropic • Command Code • OpenRouter • Crof.ai • NVIDIA NIM • Kilo.ai • DeepSeek • and more
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
@@ -32,6 +32,8 @@
|
||||
<img src="https://img.shields.io/badge/Command_Code-✓-success" />
|
||||
<img src="https://img.shields.io/badge/Streaming_SSE-✓-success" />
|
||||
<img src="https://img.shields.io/badge/Tool_Calls-✓-success" />
|
||||
<img src="https://img.shields.io/badge/AI_Assist-✓-success" />
|
||||
<img src="https://img.shields.io/badge/Self_Revive_Watchdog-✓-success" />
|
||||
</p>
|
||||
|
||||
---
|
||||
@@ -67,23 +69,23 @@ A three-component system:
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────────┐
|
||||
│ Codex Launcher GUI │
|
||||
│ (endpoint management + lifecycle) │
|
||||
│ (endpoint management + AI Assist + lifecycle) │
|
||||
└──────────┬─────────────────┬──────────────────┬────────────────────┘
|
||||
│ │ │
|
||||
┌──────▼──────┐ ┌──────▼──────┐ ┌────────▼─────────┐
|
||||
│ Codex │ │ Native │ │ Translation │
|
||||
│ Default │ │ OpenAI │ │ Proxy │
|
||||
│ (remove │ │ (direct │ │ (port 8080) │
|
||||
│ (remove │ │ (direct │ │ (auto-revive) │
|
||||
│ config) │ │ URL) │ │ │
|
||||
└──────┬──────┘ └──────┬──────┘ └────────┬─────────┘
|
||||
│ │ │
|
||||
▼ ▼ ┌────────┴────────┐
|
||||
┌──────────────┐ ┌───────────┐ │ │
|
||||
│ Built-in │ │ config. │ ▼ ▼
|
||||
│ Codex OAuth │ │ toml │ ┌────────────┐ ┌───────────┐
|
||||
└──────────────┘ └───────────┘ │ OpenAI │ │ Anthropic │
|
||||
│ Chat Comp. │ │ Messages │
|
||||
└────────────┘ └───────────┘
|
||||
│ Codex OAuth │ │ toml │ ┌────────────┐ ┌───────────┐ ┌──────────┐
|
||||
└──────────────┘ └───────────┘ │ OpenAI │ │ Anthropic │ │ Command │
|
||||
│ Chat Comp. │ │ Messages │ │ Code │
|
||||
└────────────┘ └───────────┘ └──────────┘
|
||||
```
|
||||
|
||||
---
|
||||
@@ -105,20 +107,41 @@ A three-component system:
|
||||
- **Browser UA injection** — bypasses Cloudflare bot detection for providers like OpenCode
|
||||
- **Smart URL construction** — prevents double-path bugs (`/v1/chat/completions/chat/completions`)
|
||||
- **Header forwarding** — preserves client identity headers while filtering hop-by-hop headers
|
||||
- **Self-revive watchdog** — auto-restarts proxy on crash (up to 50x, progressive backoff 1→30s)
|
||||
- **Debug-to-file logging** — all events and parser results written to `~/.cache/codex-proxy/cc-debug.log`
|
||||
- **Inline self-test** — `--self-test` flag runs 19 unit tests covering all parser edge cases
|
||||
- Zero dependencies — pure Python stdlib
|
||||
|
||||
### Command Code Adapter
|
||||
- **Multi-format tool-call parser** — handles all known CC model output formats in a cascading chain:
|
||||
- DSML tags (`<｜｜DSML｜｜invoke>`) — current model format
|
||||
- `<bash>...</bash>` blocks with metadata extraction
|
||||
- `<explore_agent>` blocks converted to real `exec_command`
|
||||
- `<tool_call type="bash">` HTML-like blocks
|
||||
- XML `<function=` patterns
|
||||
- Raw JSON `{"cmd":"..."}` embedded in text
|
||||
- Fallback regex for unrecognized tool-call signals
|
||||
- **Three-tier argument parser** — handles double-wrapped, escaped, and unicode-escaped arguments
|
||||
- **Recursive unwrapping** — handles double/triple-wrapped `cmd` values
|
||||
- **Post-extraction sanitizer** — validates every tool call has valid name + args before forwarding to Codex
|
||||
- **ErrorAnalyzer** — learns from 4xx errors, retries with adjusted parameters (max 2 retries)
|
||||
- **Schema cache** with 24h staleness TTL for provider capabilities
|
||||
|
||||
### GTK Launcher (`codex-launcher-gui`)
|
||||
- **Endpoint manager** — add, edit, delete, set default providers
|
||||
- **Provider presets** — one-click setup for 10+ providers with pre-filled URLs and model lists
|
||||
- **Provider presets** — one-click setup for 15+ providers with pre-filled URLs and model lists
|
||||
- **Model auto-fetch** — pulls available models directly from provider APIs
|
||||
- **Bulk model import** — paste a comma/newline-separated list of model IDs
|
||||
- **Launch Desktop** — starts Codex Desktop with the selected provider and model
|
||||
- **Launch CLI** — opens Codex CLI in a terminal with the selected provider
|
||||
- **Codex Default** — launch with built-in OAuth, no proxy or custom config
|
||||
- **AI Assist** — integrated AI-powered configuration assistance and troubleshooting
|
||||
- **Usage Dashboard** — per-provider tracking with dark theme, KPI strip, model bars, status pills
|
||||
- **Profile backup/import** — export and import endpoint configurations as portable JSON bundles
|
||||
- **Threaded operations** — model refresh runs in background, UI stays responsive
|
||||
- **Process lifecycle** — stall detection, kill/cleanup, config backup/restore around sessions
|
||||
- **Config normalization** — automatically strips stale API path suffixes from URLs
|
||||
- **Reasoning controls** — per-provider reasoning toggle with effort level selection
|
||||
|
||||
### Process Management
|
||||
- Kills stale electron/webview/app-server processes from previous sessions
|
||||
@@ -268,6 +291,36 @@ codex-launcher-gui
|
||||
2. On launch: backup config → **delete** `config.toml` entirely → start Codex → restore config after exit
|
||||
3. Key insight: writing empty strings (`model = ""`, `model_provider = ""`) causes Codex to error with "Model provider `` not found". The config must not exist at all for Codex to fall back to built-in defaults.
|
||||
|
||||
### Phase 7: Command Code Multi-Format Parser — The 17-Fix Odyssey
|
||||
|
||||
**Problem:** Command Code provider's tool calls were silently dropped, causing the Codex agent loop to stop after the first response. The CC model returns tool calls as inline text in wildly varying formats that change between sessions and model versions.
|
||||
|
||||
**Root Cause Analysis:**
|
||||
1. CC's `/alpha/generate` API uses a proprietary protocol — not Chat Completions, not Anthropic Messages
|
||||
2. Tool calls appear as inline text within `text-delta` SSE events, not as structured JSON
|
||||
3. The model output format is **non-deterministic** — observed 6+ distinct formats:
|
||||
- Raw JSON: `{"cmd":"mkdir -p /foo","type":"tool-call"}`
|
||||
- XML: `<function name="exec_command"><parameter name="cmd">...</parameter></function>`
|
||||
- HTML-like: `<tool_call type="bash">\n{"command":"..."}`
|
||||
- Bash blocks: `<bash>\nprefix_rule: ...\n{"command":"..."}</bash>`
|
||||
- Explore blocks: `<explore_agent>...</explore_agent>`
|
||||
- DSML tags: `<｜｜DSML｜｜invoke name="exec"><｜｜DSML｜｜parameter name="command">...</parameter></invoke>`
|
||||
4. Additional complications: double-wrapped arguments, unescaped quotes, unicode escapes, missing fields
|
||||
|
||||
**The Fix — 17 Incremental Patches:**
|
||||
Built a cascading parser chain (`DSML → bash → explore → tool_call → XML → raw JSON → fallback regex`) that tries each format in order. Each patch addressed a specific format observed in production:
|
||||
|
||||
- **FIX 1–4**: Foundation — string-only content, version headers, cache clearing, streaming error handling
|
||||
- **FIX 5–8**: Core parsing — raw JSON extraction, three-tier argument parser, field extraction, permission normalization
|
||||
- **FIX 9–10**: Cleanup — removed dead code, added documentation
|
||||
- **FIX 11–11c**: Robustness — recursive unwrapping of nested cmd values, post-extraction sanitizer, XML regex fix
|
||||
- **FIX 12**: Self-revive watchdog — proxy auto-restarts on crash instead of dying silently
|
||||
- **FIX 13–17**: New format support — fallback extraction, HTML-like blocks, explore blocks, bash blocks, DSML tags
|
||||
|
||||
**Key Design Decision:** Field-level regex extraction instead of JSON parsing. Standard JSON parsers fail on unescaped quotes in shell commands (e.g., `echo "hello world"` breaks JSON). The regex approach tolerates malformed JSON by extracting individual fields.
|
||||
|
||||
**Verification:** `--self-test` flag runs 19 automated tests covering all edge cases. Debug logging to `~/.cache/codex-proxy/cc-debug.log` captures every parser decision for troubleshooting.
|
||||
|
||||
---
|
||||
|
||||
## Architecture Deep Dive
|
||||
@@ -368,13 +421,14 @@ README.md # This file
|
||||
### Installed Locations
|
||||
|
||||
```
|
||||
~/.local/bin/translate-proxy.py # Proxy
|
||||
~/.local/bin/codex-launcher-gui # Launcher
|
||||
~/.local/bin/cleanup-codex-stale.sh # Cleanup
|
||||
~/.local/share/applications/codex-launcher.desktop # App grid entry
|
||||
~/.codex/endpoints.json # Endpoint storage
|
||||
~/.codex/config.toml # Codex config (auto-generated)
|
||||
~/.cache/codex-proxy/ # Proxy configs + model catalogs
|
||||
/usr/bin/translate-proxy.py # Proxy (from .deb)
|
||||
/usr/bin/codex-launcher-gui # Launcher (from .deb)
|
||||
/usr/bin/cleanup-codex-stale.sh # Cleanup (from .deb)
|
||||
/usr/share/applications/codex-launcher.desktop # App grid entry
|
||||
~/.codex/endpoints.json # Endpoint storage
|
||||
~/.codex/config.toml # Codex config (auto-generated)
|
||||
~/.cache/codex-proxy/ # Proxy configs + model catalogs
|
||||
~/.cache/codex-proxy/cc-debug.log # Debug log (per-request)
|
||||
```
|
||||
|
||||
---
|
||||
@@ -393,6 +447,10 @@ README.md # This file
|
||||
| Models not showing in picker | Wrong model catalog format | Must have both `slug` + `model` fields |
|
||||
| Codex hangs in "thinking" | Missing `response.completed` | Proxy emits full SSE event sequence |
|
||||
| Stops after first tool call (Crof) | `previous_response_id` not resolved | V2.1.2 stores and chains responses for multi-turn |
|
||||
| CC agent stops after first response | Tool calls not parsed from model text | V3.5 multi-format parser handles all CC output formats |
|
||||
| CC tool calls have wrong args | Double-wrapped arguments | V3.5 three-tier parser + recursive unwrapping |
|
||||
| Proxy crashes mid-session | Unhandled streaming error | V3.5 self-revive watchdog auto-restarts |
|
||||
| CC 403 upgrade_required | Missing version header | V3.5 always sends `x-command-code-version` |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user