From f9a83e486205c3beb4368127d64b53351fd90af6 Mon Sep 17 00:00:00 2001 From: admin Date: Sun, 24 May 2026 16:43:48 +0400 Subject: [PATCH] v3.8.1: update CHANGELOG.md + README.md with codebuff docs --- CHANGELOG.md | 41 ++++++++++++++++++++++++++++++++++++ README.md | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 100 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 08a8180..e6ef220 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,46 @@ # Changelog +## v3.8.1 (2026-05-24) + +**Codebuff Integration — FREE DeepSeek V4 Pro Access + Provider Presets Restored** + +### Codebuff Backend (New) +- **`codebuff` backend type** added to `translate-proxy.py` +- Connects to `https://codebuff.com` for free AI model access +- **Free models available**: DeepSeek V4 Pro, DeepSeek V4 Flash, Kimi K2.6, MiniMax M2.7 +- **Agent run lifecycle management**: auto-starts/finishes agent runs per request +- **Credential detection**: reads session token from `~/.config/manicode/credentials.json` +- **Model-to-agent routing**: maps each model to its correct codebuff agent ID + - `deepseek/deepseek-v4-pro` → `base2-free-deepseek` + - `deepseek/deepseek-v4-flash` → `base2-free-deepseek-flash` + - `moonshotai/kimi-k2.6` → `base2-free-kimi` + - `minimax/minimax-m2.7` → `base2-free` + +### Setup for Codebuff +1. `npm install -g codebuff` (already installed on system) +2. `codebuff login` (opens browser for GitHub OAuth) +3. Select "Codebuff (Free DeepSeek/Kimi)" preset in Codex Launcher GUI +4. Pick a model and start coding — no API key needed! + +### Provider Presets Restored +- All 17+ provider presets restored to `endpoints.json` +- Previous issue: endpoints.json was overwritten with only 4 AG X entries +- Restored: Command Code, Crof.ai, OpenAdapter, OpenAdapter GO Plan, OpenCode Zen (OpenAI + Anthropic), OpenCode Go (OpenAI + Anthropic), OpenRouter, NVIDIA NIM, Z.ai Coding, Google Gemini (API Key + OAuth), Google Antigravity (OAuth), Anthropic, OpenAI, Cobra (chats-llm.com) + +### GUI Changes +- New preset: **"Codebuff (Free DeepSeek/Kimi)"** in provider dropdown +- New backend type: **"Codebuff - Free DeepSeek/Kimi"** in type selector +- Version label updated to v3.8.1 +- Changelog entry for v3.8.1 added + +### Stats +- translate-proxy.py: +205 lines (codebuff backend) +- codex-launcher-gui: +19 lines (preset + changelog) +- .deb size: 84KB +- Self-tests: 54/54 passing + +--- + ## v3.8.0 (2026-05-22) **AI Monitoring — Self-Healing Watchdog with 3-Tier Response System** diff --git a/README.md b/README.md index 259fd26..fc91478 100644 --- a/README.md +++ b/README.md @@ -544,13 +544,27 @@ The launcher generates model catalog JSON with dual field naming to satisfy both | OpenCode Zen | OpenAI-compat | `https://opencode.ai/zen/v1` | | OpenCode Go | OpenAI-compat | `https://opencode.ai/zen/go/v1` | | Command Code | Command Code | `https://api.commandcode.ai` | +| **Codebuff** | **Codebuff** | `https://codebuff.com` *(free DeepSeek/Kimi)* | | Crof.ai | OpenAI-compat | `https://crof.ai/v1` | +| OpenAdapter | OpenAI-compat | `https://api.openadapter.in/v1` | | NVIDIA NIM | OpenAI-compat | `https://integrate.api.nvidia.com/v1` | | Kilo.ai | OpenAI-compat | `https://api.kilo.ai/api/gateway` | | OpenRouter | OpenAI-compat | `https://openrouter.ai/api/v1` | | Z.AI | OpenAI-compat | `https://api.z.ai/api/coding/paas/v4` | +| Google Gemini (API Key) | OpenAI-compat | `https://generativelanguage.googleapis.com/v1beta/openai` | +| Google Gemini (OAuth) | Gemini OAuth | `cloudcode-pa.googleapis.com` | +| Google Antigravity (OAuth) | Antigravity OAuth | `daily-cloudcode-pa.sandbox.googleapis.com` | | Custom | Any | User-defined | +### Free Models (via Codebuff) +Codebuff provides free access to these models — no API key needed: +- **DeepSeek V4 Pro** — Smartest model +- **DeepSeek V4 Flash** — Most efficient +- **Kimi K2.6** — Balanced +- **MiniMax M2.7** — Fastest + +*Requires: `npm install -g codebuff && codebuff login` (GitHub OAuth)* + --- ## File Structure @@ -581,6 +595,51 @@ README.md # This file --- +### Phase 10: Codebuff Integration — Free AI for Everyone (v3.8.1) + +**Problem:** Users want access to powerful models like DeepSeek V4 Pro without paying API fees. Codebuff (by CodebuffAI) offers free access to premium models through their server, but it's a CLI tool — not an API you can plug into Codex Launcher. + +**The insight:** Codebuff's backend is a Next.js app with an OpenAI-compatible `/api/v1/chat/completions` endpoint. It uses agent-run lifecycle management and model-specific routing. If we replicate the agent run protocol in our proxy, we can tap into codebuff's free tier. + +**How Codebuff works internally:** +1. User logs in via GitHub OAuth → session token stored in `~/.config/manicode/credentials.json` +2. Each request creates an **agent run** via `POST /api/v1/agent-runs` +3. Chat completions sent with `codebuff_metadata: {run_id, cost_mode: "free"}` +4. Server routes to the correct upstream provider using its own API keys +5. Agent run finished when request completes + +**What we built:** + +``` +Codex Request + │ + ▼ +┌─────────────────────────────────┐ +│ translate-proxy.py │ +│ _handle_codebuff() │ +│ │ +│ 1. Read token from credentials │ +│ 2. POST /api/v1/agent-runs │──→ {action: "START", agentId} +│ 3. POST /api/v1/chat/completions │──→ {model, messages, +│ codebuff_metadata: { +│ run_id, cost_mode: "free"}} +│ 4. Stream response back to Codex │←── SSE events +│ 5. POST /api/v1/agent-runs │──→ {action: "FINISH"} +└─────────────────────────────────┘ +``` + +**Free models available:** +| Model | Agent ID | Notes | +|-------|----------|-------| +| DeepSeek V4 Pro | `base2-free-deepseek` | Smartest | +| DeepSeek V4 Flash | `base2-free-deepseek-flash` | Most efficient | +| Kimi K2.6 | `base2-free-kimi` | Balanced | +| MiniMax M2.7 | `base2-free` | Fastest | + +**Bonus fix:** While investigating this, we discovered that `endpoints.json` had been overwritten with only 4 AG X entries, losing all 17+ provider presets. Restored all presets from proxy cache files. + +--- + ## Troubleshooting | Issue | Cause | Fix |