@elvatis_com/openclaw-cli-bridge-elvatis 0.2.28 → 0.2.30

package/.ai/handoff/HEADLESS_ROADMAP.md

@@ -0,0 +1,81 @@
+# Headless Browser Bridge — Roadmap
+
+## Ziel
+Alle Provider (Claude, Gemini, Codex/ChatGPT, Grok) über Playwright Browser-Sessions
+betreiben — keine lokalen CLI-Binaries mehr nötig. Ein headless Chromium, ein Proxy.
+
+## Aktueller Stand (v0.2.28)
+- ✅ Grok: DOM-Polling via grok.com (FERTIG, produktiv)
+- ⏳ Claude: claude CLI binary → Ziel: claude.ai headless
+- ⏳ Gemini: gemini CLI binary → Ziel: gemini.google.com headless
+- ⏳ Codex: codex CLI binary → Ziel: chatgpt.com headless
+
+## Reihenfolge
+1. **Claude headless** (claude.ai) — höchste Priorität, meistgenutzt
+2. **Gemini headless** (gemini.google.com)
+3. **Codex/ChatGPT headless** (chatgpt.com)
+
+## Pro Provider: Was zu bauen ist
+Für jeden Provider brauchen wir:
+1. `src/<provider>-browser.ts` — DOM-Automation (analog zu grok-client.ts)
+   - `sendAndWait(page, message, timeoutMs)` — message senden, auf stable DOM warten
+   - `getOrCreatePage(context)` — existierende Page reuse
+2. Persistent profile dir: `~/.openclaw/<provider>-profile/`
+3. Cookie-Expiry Tracking (analog zu grok-cookie-expiry.json)
+4. `/provider-login`, `/provider-status`, `/provider-logout` Commands
+5. `web-<provider>/*` Modell-Routing im Proxy
+6. Tests: DOM-Stub via DI-Override (analog zu grok-proxy.test.ts)
+
+## Pro Provider: DOM-Struktur zu ermitteln
+(Muss live gecaptured werden — Browser offen lassen)
+
+### Claude (claude.ai)
+- Login: Google OAuth oder Email
+- Editor selector: TBD (ProseMirror ähnlich wie Grok?)
+- Response selector: TBD
+- Anti-bot: Cloudflare?
+
+### Gemini (gemini.google.com)
+- Login: Google Account (gleicher wie Gemini CLI)
+- Editor selector: TBD
+- Response selector: TBD
+- Anti-bot: Google reCAPTCHA?
+
+### ChatGPT (chatgpt.com)
+- Login: OpenAI Account oder Google/Microsoft OAuth
+- Editor selector: TBD (ProseMirror?)
+- Response selector: TBD
+- Anti-bot: Cloudflare?
+
+## Modell-IDs (nach Implementierung)
+```
+web-claude/claude-sonnet    → claude.ai (Sonnet)
+web-claude/claude-opus      → claude.ai (Opus, Pro plan)
+web-gemini/gemini-2-5-pro   → gemini.google.com (2.5 Pro)
+web-gemini/gemini-flash     → gemini.google.com (Flash)
+web-chatgpt/gpt-4o          → chatgpt.com (GPT-4o)
+web-chatgpt/gpt-o3          → chatgpt.com (o3)
+web-grok/grok-3             → grok.com (✅ bereits fertig)
+```
+
+## Version-Plan
+- v0.2.x  — Claude headless (+ Tests)
+- v0.3.x  — Gemini headless (+ Tests)
+- v0.4.x  — ChatGPT headless (+ Tests)
+- **v1.0.0** — Alle 4 Provider headless, CLI-Dependencies optional,
+               vollständige Testabdeckung, CHANGELOG komplett
+
+## Voraussetzungen vor jedem Provider-Release
+- [ ] Alle Tests grün (inkl. neuer Provider-Tests)
+- [ ] DOM-Struktur gecaptured (echte Requests intercepted)
+- [ ] Cookie-Expiry Tracking implementiert
+- [ ] Persistent profile directory dokumentiert
+- [ ] Manuelle End-to-End Test durchgeführt
+- [ ] Alle 3 Plattformen published (GitHub, npm, ClawHub)
+
+## Notizen
+- DOM-Polling interval: 500ms, stable after 3 consecutive identical reads
+- Timeout default: 120s (konfigurierbar via pluginConfig.timeoutMs)
+- Jeder Provider: eigenes Chromium-Profil → Cookies unabhängig
+- Grok-Strategie: grok.com öffnen, ProseMirror füllen, Enter, .message-bubble pollen
+- Cloudflare-Bypass: KEINE direkten fetch()-Calls — immer DOM-Automation

package/.ai/handoff/STATUS.md

@@ -1,78 +1,54 @@
-# STATUS.md — openclaw-cli-bridge-elvatis
-
-<!-- SECTION: summary -->
-v0.2.25 built + tested (51/51). Staged model switching + token refresh stability. Ready to publish.
-<!-- /SECTION: summary -->
-
-<!-- SECTION: version -->
-## Current Version: 0.2.25 — STABLE (unpublished)
-
-_Last session: 2026-03-11 — Akido (claude-sonnet-4-6)_
-
-| Platform | Version | Status |
-|----------|---------|--------|
-| GitHub | v0.2.25 | ✅ Tagged + Release |
-| npm | 0.2.25 | ✅ Published |
-| ClawHub | 0.2.25 | ✅ Published (direct API — clawhub CLI v0.7.0 bug: missing acceptLicenseTerms) |
-| Local | 0.2.25 | ✅ Up to date |
-<!-- /SECTION: version -->
-
-<!-- SECTION: build_health -->
-## Build Health
-
-| Check | Result | Notes |
-|-------|--------|-------|
-| `npm run build` | ✅ | TypeScript compiles clean, no errors |
-| `npm test` | ✅ 51/51 | All tests pass |
-| `npm run typecheck` | ✅ | Implied by build |
-| Plugin loads in gateway | ✅ | Verified at v0.2.21; no structural changes |
-<!-- /SECTION: build_health -->
-
-<!-- SECTION: what_is_done -->
-## What Is Done
-
-### Session-Safety: Staged Model Switching (v0.2.25)
-- ✅ **`/cli-*` stages by default** — switch saved to `~/.openclaw/cli-bridge-pending.json`, NOT applied. Shows warning + instructions.
-- ✅ **`/cli-* --now`** — immediate switch (user's explicit choice; only use between sessions)
-- ✅ **`/cli-apply`** — apply staged switch after finishing current task
-- ✅ **`/cli-pending`** — show staged switch state
-- ✅ **`/cli-back`** — restore previous model + clear any staged switch
-- ✅ **`/cli-list`** — updated to show pending state + switching instructions
-
-### Token Refresh Stability (v0.2.25 — merged from v0.2.24)
-- ✅ Sleep-resilient: `setInterval(10min)` polling instead of long `setTimeout`
-- ✅ No timer-leak: `stopTokenRefresh()` called at top of `scheduleTokenRefresh()`
-- ✅ `stopTokenRefresh()` exported; called via `server.on("close")`
-
-### Previously Validated (v0.2.23 and below)
-- ✅ Phase 1: `openai-codex` provider via `~/.codex/auth.json`
-- ✅ Phase 2: Local proxy on `127.0.0.1:31337` (Gemini + Claude CLI)
-- ✅ Phase 3: 15 slash commands (all `/cli-*`)
-- ✅ Model allowlist, vllm prefix stripping, buildMinimalEnv XDG vars
-- ✅ End-to-end tested: claude-sonnet-4-6 ✅ claude-haiku-4-5 ✅ gemini-2.5-flash ✅ gemini-2.5-pro ✅ codex ✅
-<!-- /SECTION: what_is_done -->
-
-<!-- SECTION: what_is_missing -->
-## What Is Missing / Open
-
-- ✅ **v0.2.25 published** — GitHub, npm, ClawHub alle auf 0.2.25
-- ℹ️ **Claude CLI auth expires ~90 days** — when `/cli-test` returns 401, run `claude auth login`
-- ℹ️ **Config patcher writes `openclaw.json` directly** — triggers one gateway restart on first install
-- ℹ️ **ClawHub publish ignores `.clawhubignore`** — use rsync workaround (see CONVENTIONS.md)
-<!-- /SECTION: what_is_missing -->
-
-<!-- SECTION: bugs_fixed -->
-## Bug History
-
-| Version | Bug | Fix |
-|---------|-----|-----|
-| 0.2.25 | `/cli-*` mid-session breaks active agent (silent tool-call failures) | Staged switch by default; --now for explicit immediate |
-| 0.2.25 | Timer-leak in scheduleTokenRefresh | stopTokenRefresh() clears interval on every call |
-| 0.2.25 | Long setTimeout missed after system sleep/resume | setInterval(10min) polling |
-| 0.2.25 | Token refresh interval leaked on proxy close | server.on("close", stopTokenRefresh) |
-| 0.2.21 | Claude Code OAuth 401 on Gnome Keyring | buildMinimalEnv forwards XDG_RUNTIME_DIR |
-| 0.2.14 | vllm/ prefix not stripped → unknown model | Strip prefix before routing |
-| 0.2.13 | requireAuth:true blocked webchat commands | requireAuth:false |
-| 0.2.9 | fuser -k SIGKILL'd gateway process | Safe health probe |
-| 0.2.7–8 | EADDRINUSE on hot-reload | closeAllConnections() + registerService |
-<!-- /SECTION: bugs_fixed -->
+# STATUS — openclaw-cli-bridge-elvatis
+
+## Current Version: 0.2.28 (npm + ClawHub + GitHub)
+
+## What's Done
+- v0.2.25: Sleep-resilient token refresh (setInterval), staged /cli-* switch
+- v0.2.26: Grok DOM-polling bridge (grok-client.ts, grok-session.ts)
+- v0.2.27: Persistent Chromium profile (~/.openclaw/grok-profile/)
+- v0.2.28: Cookie-expiry tracking (/grok-status shows ✅/⚠️/🚨)
+- claude-browser.ts: DOM-automation for claude.ai (not yet in proxy — NEXT)
+- 77/77 tests green
+
+## Next: v0.3.x → v1.0.0 — Full Headless Provider Bridge
+
+### Provider Status
+| Provider | DOM confirmed | browser.ts | Proxy routed | Login cmd | Tests |
+|---|---|---|---|---|---|
+| Grok | ✅ | ✅ grok-client.ts | ✅ web-grok/* | ✅ /grok-login | ✅ |
+| Claude | ✅ | ✅ claude-browser.ts | ❌ | ❌ | partial |
+| Gemini | ❌ | ❌ | ❌ | ❌ | ❌ |
+| ChatGPT | ❌ | ❌ | ❌ | ❌ | ❌ |
+
+### Claude DOM (confirmed 2026-03-11)
+- URL: https://claude.ai/new
+- Editor: .ProseMirror (tiptap)
+- Messages: [data-test-render-count] divs
+- Assistant msgs: child div class "group" (no "mb-1 mt-6")
+- User msgs: child div class "mb-1 mt-6 group"
+- CLOUDFLARE: persistent headless blocked — must use OpenClaw browser (CDP 18800)
+- Tested working: CLAUDE_WORKS response confirmed via OpenClaw browser
+
+### Next Steps (in order)
+1. Add connectToOpenClawBrowser() to claude-browser.ts (same as grok-session.ts)
+2. Add web-claude/* routing to proxy-server.ts (same as web-grok/*)
+3. Add /claude-login, /claude-status, /claude-logout to index.ts
+4. Add claude-browser integration tests (DI-override, same as grok-proxy.test.ts)
+5. Repeat for Gemini (gemini.google.com) and ChatGPT (chatgpt.com)
+6. Bump to v1.0.0 when all 4 providers green + all tests pass
+
+## Key Files
+- src/claude-browser.ts — Claude DOM automation (ready, not wired)
+- src/grok-client.ts — reference implementation
+- src/grok-session.ts — reference for login/session management
+- src/proxy-server.ts — add web-claude/* routing here
+- index.ts — add /claude-login here
+- test/claude-browser.test.ts — unit tests (partial, needs proxy integration test)
+
+## Constraints
+- OpenClaw browser (CDP 18800) required for Cloudflare bypass
+- persistent profile approach fails (fingerprint mismatch)
+- Each provider: own profile dir ~/.openclaw/<provider>-profile/
+- All providers share same proxy port 31337
+- Publish only after full test pass (77+ tests green)
+- All 3 platforms on every release: GitHub + npm + ClawHub

package/README.md

@@ -2,7 +2,7 @@
 
 > OpenClaw plugin that bridges locally installed AI CLIs (Codex, Gemini, Claude Code) as model providers — with slash commands for instant model switching, restore, health testing, and model listing.
 
-**Current version:** `0.2.28`
+**Current version:** `0.2.30`
 
 ---
 
@@ -287,6 +287,21 @@ npm test            # vitest run (45 tests)
 
 ## Changelog
 
+### v0.2.30
+- **feat:** `gemini-browser.ts` — gemini.google.com DOM-automation (Quill editor + message-content polling)
+- **feat:** `web-gemini/*` models in proxy (gemini-2-5-pro, gemini-2-5-flash, gemini-3-pro, gemini-3-flash)
+- **feat:** `/gemini-login`, `/gemini-status`, `/gemini-logout` commands + cookie-expiry tracking
+- **fix:** Singleton CDP connection — no more zombie Chromium processes
+- **fix:** `cleanupBrowsers()` called on plugin stop — all browser resources released
+- **test:** 90/90 tests green (+6 gemini-proxy tests)
+
+### v0.2.29
+- **feat:** `claude-browser.ts` — claude.ai DOM-automation (ProseMirror + `[data-test-render-count]` polling)
+- **feat:** `web-claude/*` models in proxy (web-claude/claude-sonnet, claude-opus, claude-haiku)
+- **feat:** `/claude-login`, `/claude-status`, `/claude-logout` commands
+- **feat:** Claude cookie-expiry tracking (`~/.openclaw/claude-cookie-expiry.json`)
+- **test:** 84/84 tests green (+7 claude-proxy tests, +8 claude-browser unit tests)
+
 ### v0.2.28
 - **feat:** `/grok-login` scans auth cookie expiry (sso cookie) and saves to `~/.openclaw/grok-cookie-expiry.json`
 - **feat:** `/grok-status` shows cookie expiry with color-coded warnings (🚨 <7d, ⚠️ <14d, ✅ otherwise)

package/SKILL.md

@@ -53,4 +53,4 @@ Each command runs `openclaw models set <model>` atomically and replies with a co
 
 See `README.md` for full configuration reference and architecture diagram.
 
-**Version:** 0.2.28
+**Version:** 0.2.30