Danny/kernel 716 cli gemini cua template action broken

[dprevoznik]

Fix: Update Gemini Computer Use template for Stagehand v3 compatibility

Description

Updates the Gemini Computer Use template to work with Stagehand v3 API, which introduced breaking changes from v2.

Changes

🔧 Stagehand v3 Migration (index.ts)

• Removed OpenAI dependency: The template now only requires GOOGLE_API_KEY (Stagehand v3 no longer requires a separate OpenAI key for its internal operations)

• Updated Stagehand initialization:

  • domSettleTimeoutMs → domSettleTimeout
  • Removed modelName and modelClientOptions from constructor

• Updated page access: stagehand.page → stagehand.context.pages()[0]

• Updated agent configuration to v3 format:
  // v2 (old)
  stagehand.agent({
  provider: "google",
  model: "gemini-2.5-...",
  instructions: "...",
  options: { apiKey: ... }
  })

  // v3 (new)
  stagehand.agent({
  cua: true,
  model: { modelName: "google/gemini-2.5-...", apiKey: ... },
  systemPrompt: "..."
  })

  ✨ Template Improvements

• Made task configurable via startingUrl and instruction payload parameters

• Changed default example to use magnitasks.com Kanban board demo (more reliable than YCombinator search)

• Added CuaTaskInput interface for typed payload support

📚 Documentation Updates

• Removed OPENAI_API_KEY from setup requirements
• Added "Alternative Model Providers" section showing how to switch to OpenAI or Anthropic
• Improved deployment instructions to use --env-file .env approach
• Updated .env.example to remove unnecessary OpenAI key

Testing

• make build passes
• make test passes
• /qa cursor command passes

Related

Fixes KERNEL-716

---

Note

^{Cursor Bugbot is generating a summary for commit 5678806. Configure here.}

[masnwilliams]

lgtm