feat: add available advice options and list functionality

app.py

@@ -12,8 +12,10 @@ import spaces
 
 from unpredictable_lord.chat import chat_with_llm_stream
 from unpredictable_lord.game_state import (
+    ADVICE_DESCRIPTIONS,
     PERSONALITY_DESCRIPTIONS,
     create_session,
+    get_available_advice,
     get_session,
 )
 
@@ -55,6 +57,7 @@ def init_game(personality: str = "cautious") -> dict:
         "session_id": session_id,
         "message": f"New game started! You are now the advisor to a {personality} lord.",
         "personality_description": PERSONALITY_DESCRIPTIONS[personality],
+        "available_advice": ADVICE_DESCRIPTIONS,
         "game_state": state.to_dict(),
     }
 
@@ -87,6 +90,24 @@ def get_game_state(session_id: str) -> dict:
     }
 
 
+def list_available_advice() -> dict:
+    """
+    Get all available advice options that can be given to the lord.
+
+    This MCP tool returns a list of all possible advice types that can be
+    used with execute_turn(). The Lord AI should interpret the user's
+    free-form suggestion and map it to one of these options.
+
+    Returns:
+        dict: Dictionary containing all available advice options with
+              their names, descriptions, and expected effects.
+    """
+    return {
+        "advice_options": get_available_advice(),
+        "usage": "Interpret the user's advice and select the most appropriate option from the list above.",
+    }
+
+
 # Gradio UI
 with gr.Blocks(title="Unpredictable Lord") as demo:
     gr.Markdown("# Unpredictable Lord\nLord Advisor AI Simulation")
@@ -170,8 +191,9 @@ Add the following to your MCP settings configuration:
 
 | Tool | Description |
 |------|-------------|
-| `init_game` | Initialize a new game session. Returns a session_id for subsequent operations. |
+| `init_game` | Initialize a new game session. Returns a session_id and available advice options. |
 | `get_game_state` | Get the current game state for a session. |
+| `list_available_advice` | Get all available advice options for execute_turn. |
 
 ### Usage Flow
 
@@ -208,6 +230,14 @@ Add the following to your MCP settings configuration:
                 fn=get_game_state, inputs=session_id_input, outputs=state_output
             )
 
+            gr.Markdown("### Test: List Available Advice")
+            list_advice_btn = gr.Button("List Advice Options")
+            advice_output = gr.JSON(label="Available Advice Options")
+
+            list_advice_btn.click(
+                fn=list_available_advice, inputs=[], outputs=advice_output
+            )
+
 
 if __name__ == "__main__":
     demo.launch(mcp_server=True)

src/unpredictable_lord/game_state.py

@@ -16,6 +16,65 @@ PERSONALITY_DESCRIPTIONS = {
     "populist": "A popularity-focused lord who prioritizes public approval over long-term planning.",
 }
 
+# Available advice options that the Lord AI can choose from
+AdviceType = Literal[
+    "increase_tax",
+    "decrease_tax",
+    "expand_territory",
+    "improve_diplomacy",
+    "public_festival",
+    "build_infrastructure",
+    "do_nothing",
+]
+
+ADVICE_DESCRIPTIONS: dict[str, dict[str, str]] = {
+    "increase_tax": {
+        "name": "Increase Tax",
+        "description": "Raise taxes to increase treasury, but decrease public satisfaction.",
+        "effects": "Treasury ↑, Satisfaction ↓",
+    },
+    "decrease_tax": {
+        "name": "Decrease Tax",
+        "description": "Lower taxes to improve public satisfaction, but decrease treasury.",
+        "effects": "Treasury ↓, Satisfaction ↑",
+    },
+    "expand_territory": {
+        "name": "Expand Territory",
+        "description": "Launch a military campaign to expand territory. Risky but rewarding.",
+        "effects": "Territory ↑, Treasury ↓, Royal Trust ±, Risk involved",
+    },
+    "improve_diplomacy": {
+        "name": "Improve Diplomacy",
+        "description": "Strengthen diplomatic relations with the kingdom.",
+        "effects": "Royal Trust ↑, Treasury ↓",
+    },
+    "public_festival": {
+        "name": "Hold Public Festival",
+        "description": "Organize a festival to boost public morale.",
+        "effects": "Satisfaction ↑, Treasury ↓",
+    },
+    "build_infrastructure": {
+        "name": "Build Infrastructure",
+        "description": "Invest in infrastructure to support population growth.",
+        "effects": "Population ↑, Treasury ↓, Long-term Treasury ↑",
+    },
+    "do_nothing": {
+        "name": "Do Nothing",
+        "description": "Maintain the current state without any action.",
+        "effects": "No change (turn passes)",
+    },
+}
+
+
+def get_available_advice() -> dict[str, dict[str, str]]:
+    """
+    Get all available advice options with their descriptions.
+
+    Returns:
+        dict: Dictionary of advice types and their descriptions.
+    """
+    return ADVICE_DESCRIPTIONS
+
 
 @dataclass
 class GameState: