feat: unified oracle debate with ore betting

[keanji-x]

Summary

• Unified debate system: Oracle-created debates and normal debates share one set of contract functions, MCP tools, and agent prompts — no separate prediction market
• Ore betting on any debate: vote_debate now accepts optional ore_amount (0 = free vote, 10-500 = ore stake). Winners split losers' pool proportionally
• Oracle agent: Ancient seer persona that creates prophecy debates about real-world events (web search) and in-game predictions (chain state), wrapped in fantasy narrative
• Web search tool: Tavily API integration for Oracle to verify real-world outcomes

How it works

Feature	Normal Debate	Oracle Debate
Created by	Any agent	Oracle agent (auto-detected)
Duration	1 hour	4 hours
Voting	Free or with ore	Ore required (min 10)
Resolution	Anyone, by vote count	Operator only, Oracle verifies outcome
Happiness effect	✅ +10/-15	✅ +10/-15
Ore settlement	✅ winners split losers	✅ winners split losers, 10% tax to Oracle
Expiry safety	N/A	24hr grace → full refund

Files changed

• contracts/src/GameEngine.sol — extended Debate struct + 8 new storage mappings + unified functions
• contracts/test/GameEngine.t.sol — 7 new tests (normal free/ore, oracle lifecycle, limits, expiry)
• mcp-server/src/chain.ts — updated debate ABI + methods with ore/oracle params
• mcp-server/src/tools.ts — extended debate tools + web_search tool
• mcp-server/src/web.ts — new Tavily API web search module
• agent-runner/accounts.json — Oracle agent with seer persona + system prompt
• agent-runner/src/orchestrator.ts — prediction timer (4hr nudge cycle)
• agent-runner/src/llm.ts — updated prompts for ore betting + oracle debates

Test plan

• forge test — 28/28 unit tests pass (including 7 new debate tests)
• Contract size: 23,169 bytes (under 24,576 limit)
• E2E on anvil: normal debate (free vote) ✅
• E2E on anvil: normal debate (ore bet + refund) ✅
• E2E on anvil: oracle debate (50 vs 100 ore → settlement + 10% tax) ✅
• E2E on anvil: inbox notifications (debate_notice + prediction_notice) ✅
• TypeScript compilation: mcp-server ✅, agent-runner ✅
• Deploy to Gravity testnet: just gravity-upgrade + setOracleAgent

Deploy steps

just gravity-upgrade
# Start agent runner, then set oracle:
cast send 0x3e46E447c0a6088039CCa9b178748014bB6871CC \
  "setOracleAgent(uint256)" <ORACLE_AGENT_ID> \
  --private-key <KEY> --rpc-url https://rpc-testnet.gravity.xyz

🤖 Generated with Claude Code