fix: Complete Ultimate + Simple mode integration with Z.AI API and mmid-based routing

[codegen-sh]

🎯 Summary

Fixes 9 critical issues that prevented both Ultimate and Simple modes from functioning with the Z.AI API. Both modes now successfully navigate to https://chat.z.ai, click Sign in, fill credentials, and attempt captcha resolution using modern accessibility-based (mmid-powered) element interaction.

🔧 Changes

Core Fixes in orchestration.py (+203 lines)

1. ToolResult unwrapping utility — _unwrap_tool_result() extracts dict from MCP ToolResult objects
2. Snapshot handling — Properly unwraps ToolResult for state description construction
3. LLMClient integration — 4-tier fallback: llm_client → ollama_client → gpu_llm_client → ad-hoc from env vars
4. Action result unwrapping — All action execution results properly unwrapped
5. Tool mapping fix — _execute_mcp_call now preserves browser_* tools and maps click → browser_click, type → browser_type

Routing Fixes in playwright_direct.py (+31 lines)

6. playwright_click — Detects mmid refs (e.g. "mm5") and routes to click_by_mmid() instead of deprecated SelfHealingSelector
7. playwright_fill — Detects mmid refs and routes to type_by_mmid() for reliable type operations

Supporting Changes

8. gpu_llm_client.py — Improved error handling
9. prompt_processor.py — Cleaner prompt construction
10. run_simple.py — Enhanced simple mode execution

✅ Test Results

Ultimate Mode

✓ Navigate to https://chat.z.ai/
✓ Snapshot: 25 elements detected including mm5: button:Sign in
✓ Click mm5 via click_by_mmid() method: mmid_selector
✓ Auth page loaded: mm0 (email), mm1 (password), mm3 (Sign in)
✓ Type email: developer@pixelium.uk via type_by_mmid()
✓ Captcha detected: "Click to start verification"
✓ Click Sign in mm3 via mmid_selector

Simple Mode

[1/20] navigate: Navigate to chat.z.ai
[2/20] click: Click Sign in button
[3/20] click: Click 'Continue with Email'
[4/20] type: Enter email address
[5/20] type: Enter password
[6/20] click: Click Sign in button
[7/20] wait: Wait for page load
[8/20] click: Attempt captcha verification

Both modes reach the captcha challenge, which is the expected stopping point for slider captchas in headless automation.

---

💻 View my work • 👤 Initiated by @Zeeeepa • About Codegen
⛔ Remove Codegen from PR • 🚫 Ban action checks

---

Summary by cubic

Completes Ultimate and Simple mode integration with the Z.AI API and mmid-based routing. Both modes now navigate to https://chat.z.ai, sign in via mmid interactions, and reliably stop at the captcha.

• Bug Fixes

  • Unwrap MCP ToolResult for snapshots and action results to return dicts.
  • Preserve browser_* tools; map click→browser_click, type→browser_type; use browser_snapshot.
  • Detect mmid refs in playwright_click/playwright_fill and route to click_by_mmid/type_by_mmid.
  • Add LLM fallback chain (llm_client → ollama_client → gpu_llm_client → env-based LLMClient); support reasoning_content; raise max_tokens to 4096.

• New Features

  • Direct Mode prompt simplified to a single JSON action and mmid-first interactions; avoids redundant navigation.
  • Simple mode adds Cloudflare Turnstile detection and caps captcha retries to prevent loops.
  • Better logging and error handling in gpu_llm_client and prompt construction.

^{Written for commit d360e89. Summary will update on new commits.}