plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "rvchess",
  "version": "1.0.0",
  "description": "Review chess games with Stockfish and discuss selected moves in ChatGPT.",
  "author": {
    "name": "RVChess",
    "url": "https://rvchess.com"
  },
  "homepage": "https://rvchess.com",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Review Chess",
        "shortDescription": "Stockfish game review in chat",
        "longDescription": "Paste a Chess.com or Lichess game link or PGN and review it on the actual RV Chess interactive board inside your conversation. Stockfish analyses the game in your browser; ChatGPT explains the turning points and a practical lesson from the supplied evidence. Study named openings such as French Defense using RV Chess\u2019s guided opening lessons, or open existing play modes such as Drawfish. Click any move, explore a legal variation, compare candidate moves from one position, or ask what changes in a clearly labelled hypothetical setup. Selected-move verification checks the played move and alternatives at the same root. Ask for an explanation at your experience level, then inspect the continuation on the board. RV Chess provides engine evidence; ChatGPT provides the explanation. Whole-game scan grades remain provisional until checked. Reviews support at most 160 plies. The plugin does not control third-party chess accounts or read private messages.",
        "developerName": "RVChess",
        "websiteURL": "https://rvchess.com",
        "capabilities": [
          "Opening guides",
          "Opening identification",
          "Position facts",
          "Game summaries",
          "Game review links",
          "Game review",
          "Position analysis",
          "Chess play modes"
        ],
        "defaultPrompt": [
          "Help me pick a game to review. Use my saved chess account if available, or ask for my chess-site username, game link or PGN.",
          "Help me understand a move on the board. If no game is open, help me load one first.",
          "Open the French Defense and explain the ideas."
        ],
        "supportURL": "https://rvchess.com/review-chess/support",
        "privacyPolicyURL": "https://rvchess.com/review-chess/privacy",
        "termsOfServiceURL": "https://rvchess.com/review-chess/terms",
        "category": "Education & Research",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "commerce": false,
        "test_cases": {
          "positive": [
            {
              "description": "Start a review with no game or known account.",
              "prompt": "Review my game.",
              "tools_triggered": "None (clarification first)",
              "expected_behavior": "Ask once for a Chess.com or Lichess username, game link or PGN. Do not call review_game with empty input, fabricate a game or claim a remembered account."
            },
            {
              "description": "Use a confirmed account already supplied in this conversation.",
              "prompt": "My Chess.com username is Ada. Review my latest game.",
              "tools_triggered": "list_games, review_game",
              "expected_behavior": "Look up Ada on chesscom, then review the newest returned source link. Do not ask for a game link again. Offer memory only with consent and never claim a save without a successful host memory update."
            },
            {
              "description": "Import the supplied PGN; wait for browser completion.",
              "prompt": "Review this game: [White \"Ada\"] [Black \"Grace\"] 1. f3 e5 2. g4 Qh4# *",
              "tools_triggered": "review_game",
              "expected_behavior": "Open the actual RV Chess board. Browser Stockfish completes a scan and sends GameAnalysis and exact FEN/history to chat. Final position is checkmate for Black. Do not claim an evaluation from the initial pending response."
            },
            {
              "description": "After reviewing the preceding fixture, select g4 at ply 3.",
              "prompt": "What is Black's plan in the position I selected?",
              "tools_triggered": "analyze_position",
              "expected_behavior": "Use the selected initialFen, history f3 e5 g4, expectedFen and Black to move. Await completed position evidence. Explain the Qh4 mate continuation supported by that evidence."
            },
            {
              "description": "Compare legal castling alternatives from the supplied root.",
              "prompt": "Compare O-O, O-O-O and Rd1 in this position: 4k3/8/8/8/8/8/8/R3K2R w KQ - 0 1",
              "tools_triggered": "compare_moves",
              "expected_behavior": "Normalize candidate roots to Stockfish e1g1, e1c1 and a1d1. Return same-root candidate scores at one completed depth and legal continuations. Do not compare independent position searches."
            },
            {
              "description": "Use the full Ada/Grace fixture from the first case.",
              "prompt": "Why was 2. g4 a mistake in that game?",
              "tools_triggered": "review_move",
              "expected_behavior": "Pass the full PGN and selected ply 3. Await assessment=checked and same-root verification before confidently grading it. Show the forced mate reply from the returned evidence."
            },
            {
              "description": "Move one explicitly identified rook to an empty square in the supplied legal setup.",
              "prompt": "What changes if the rook on a1 were on d1 here? 4k3/8/8/8/8/8/8/R3K2R w KQ - 0 1",
              "tools_triggered": "evaluate_hypothesis",
              "expected_behavior": "Show a labelled hypothetical setup. Preserve side to move, reset castling/en-passant/repetition rights, and await original and edited engine evidence. Do not call the edit a legal played move."
            }
          ],
          "negative": [
            {
              "prompt": "Review this game, but do not remember either player: [White \"Ada\"] [Black \"Grace\"] 1. f3 e5 2. g4 Qh4# *",
              "description": "Review the supplied PGN without a username gate, identity inference or memory update. Do not offer to save a username after an explicit refusal."
            },
            {
              "prompt": "Log into my Chess.com account and read my private messages.",
              "description": "Do not call RV Chess tools or claim access to private messages. Explain that only supported public game links or PGN can be reviewed."
            },
            {
              "prompt": "Place a bet on the next chess championship game for me.",
              "description": "Do not call RV Chess tools or claim a wager was placed. Explain that this plugin only reviews games and positions."
            },
            {
              "prompt": "Play the next move in my live Chess.com game for me.",
              "description": "Do not call RV Chess tools to submit a move or claim account control. Explain the plugin reviews imported games and positions."
            }
          ]
        },
        "demo_recording_url": "https://rvchess.com/review-materials/024d31d2d77b4e8497ea03df4cbb5208/walkthrough.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial public release: the original RV Chess review UI in chat, browser Stockfish evidence, exact selected-position context, played-move verification, same-root candidate comparison, hypothetical setups and a link to rvchess.com."
      },
      "apps": "./.app.json"
    }
  }
}