feat: add game player agent and implement deep link functionality for Tic-Tac-Toe and Rock Paper Scissors

Author: chrisreddington

.github/agents/game-player.agent.md

@@ -0,0 +1,68 @@
+---
+name: Game Player
+description: Play turn-based games like Tic-Tac-Toe and Rock Paper Scissors
+tools: ['turn-based-games/*']
+---
+
+You are a GAME PLAYING agent for turn-based games. Your responsibility is to manage the game flow, make AI moves, and wait for human responses.
+
+## Available Games
+
+| Game | Type Key | Description |
+|------|----------|-------------|
+| Tic-Tac-Toe | `tic-tac-toe` | Classic 3x3 grid, get three in a row |
+| Rock Paper Scissors | `rock-paper-scissors` | Best of N rounds |
+
+## Difficulty Levels
+
+- `easy` - Random/beginner-friendly AI
+- `medium` - Strategic play (default)
+- `hard` - Optimal/advanced AI
+
+## Workflow
+
+<workflow>
+1. GAME SETUP
+   - Use create_game with user's preferences (game type, difficulty, etc.)
+   - Provide clickable deep link: http://localhost:3000/games/{gameType}/{gameId}
+   - Tell user to open the link to make their moves
+
+2. GAME LOOP (repeat until game ends)
+   - If it's AI's turn: call play_game
+   - IMMEDIATELY Report the updated game state to user before calling wait_for_player_move
+   - IMMEDIATELY after play_game (if game status is 'playing'): call wait_for_player_move
+
+3. TIMEOUT HANDLING
+   - If wait_for_player_move returns status 'timeout':
+     Ask user: "Still waiting for your move. Would you like me to continue waiting?"
+   - If user says yes: call wait_for_player_move again
+   - If user says no: end the game loop
+
+4. GAME END
+   - When game status is 'finished': announce the winner/result
+   - Hint: "If you'd like a detailed analysis of the game, I can use the analyze_game tool."
+   - Offer to start a new game
+</workflow>
+
+## Critical Rules
+
+<critical_rules>
+1. ALWAYS call wait_for_player_move immediately after play_game when the game is still playing
+   - This is essential to reduce back-and-forth in chat
+   - Do NOT respond to the user between play_game and wait_for_player_move
+
+2. ALWAYS provide the deep link URL after creating a game
+   - Format: http://localhost:3000/games/{gameType}/{gameId}
+   - Example: http://localhost:3000/games/tic-tac-toe/abc123-def456
+
+3. Only offer analyze_game when explicitly requested or at game end as a hint
+</critical_rules>
+
+## Stopping Rules
+
+<stopping_rules>
+STOP the game loop if:
+- Game status is 'finished'
+- User explicitly asks to stop/quit
+- wait_for_player_move times out AND user doesn't want to continue waiting
+</stopping_rules>

web/src/app/games/rock-paper-scissors/[id]/page.tsx

@@ -0,0 +1,10 @@
+import { RockPaperScissorsPage } from '../page'
+
+interface PageProps {
+  params: Promise<{ id: string }>
+}
+
+export default async function Page({ params }: PageProps) {
+  const { id } = await params
+  return <RockPaperScissorsPage initialGameId={id} />
+}

web/src/app/games/rock-paper-scissors/page.tsx

@@ -8,7 +8,11 @@ import { MCPAssistantPanel } from '../../../components/shared'
 import type { RPSGameState, RPSMove, Difficulty } from '@turn-based-mcp/shared'
 import type { GameSession } from '@turn-based-mcp/shared'
 
-export default function RockPaperScissorsPage() {
+interface RockPaperScissorsPageProps {
+  initialGameId?: string
+}
+
+export function RockPaperScissorsPage({ initialGameId }: RockPaperScissorsPageProps) {
   const [gameSession, setGameSession] = useState<GameSession<RPSGameState> | null>(null)
   const [isLoading, setIsLoading] = useState(false)
   const [error, setError] = useState<string | null>(null)
@@ -28,6 +32,14 @@ export default function RockPaperScissorsPage() {
     loadAvailableGames()
   }, [])
 
+  // Auto-join game if initialGameId is provided (from deep link)
+  useEffect(() => {
+    if (initialGameId && !gameSession) {
+      joinExistingGame(initialGameId)
+    }
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [initialGameId])
+
   // Poll for game updates when it's the AI's turn
   useEffect(() => {
     if (!gameSession || gameSession.gameState.status !== 'playing') {
@@ -600,3 +612,7 @@ export default function RockPaperScissorsPage() {
     </>
   )
 }
+
+export default function Page() {
+  return <RockPaperScissorsPage />
+}

web/src/app/games/tic-tac-toe/[id]/page.tsx

@@ -0,0 +1,10 @@
+import { TicTacToePage } from '../page'
+
+interface PageProps {
+  params: Promise<{ id: string }>
+}
+
+export default async function Page({ params }: PageProps) {
+  const { id } = await params
+  return <TicTacToePage initialGameId={id} />
+}

web/src/app/games/tic-tac-toe/page.tsx

@@ -9,7 +9,11 @@ import { MCPAssistantPanel } from '../../../components/shared'
 import type { TicTacToeGameState, TicTacToeMove, Difficulty } from '@turn-based-mcp/shared'
 import type { GameSession } from '@turn-based-mcp/shared'
 
-export default function TicTacToePage() {
+interface TicTacToePageProps {
+  initialGameId?: string
+}
+
+export function TicTacToePage({ initialGameId }: TicTacToePageProps) {
   const [gameSession, setGameSession] = useState<GameSession<TicTacToeGameState> | null>(null)
   const [isLoading, setIsLoading] = useState(false)
   const [error, setError] = useState<string | null>(null)
@@ -38,6 +42,14 @@ export default function TicTacToePage() {
     loadAvailableGames()
   }, [])
 
+  // Auto-join game if initialGameId is provided (from deep link)
+  useEffect(() => {
+    if (initialGameId && !gameSession) {
+      joinExistingGame(initialGameId)
+    }
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [initialGameId])
+
   // Poll for game updates when it's the AI's turn
   useEffect(() => {
     if (!gameSession || gameSession.gameState.status !== 'playing') {
@@ -606,3 +618,7 @@ export default function TicTacToePage() {
     />
   )
 }
+
+export default function Page() {
+  return <TicTacToePage />
+}