finished Readme

README.md

@@ -24,6 +24,119 @@ This is my submission for the Text Adventure Agent assignment. My agent uses the
 - What tools did you implement in your MCP server?
 - Any interesting techniques or optimizations?
 
+
+1. Long-Term Memory System (Rolling Summary)
+To avoid the LLM context prompt growing forever and hiting token limits (or losing focus), i've added a cyclic summary system:
+
+Interval: Every 10 steps (configurabe in __init__), the agent pauses to consolidate info.
+
+Process: The agent takes the previous summary + the last 10 actions, and asks the LLM to generate a new consolidated summary of max 4 paragraphs.
+
+Efficency: Once summarized, the history of those 10 actions is wiped, keeping the prompt always short, clean and focused on what matters (goals, items found, places discovered). Also specific general prompt is made to make the agent be more effective, clever and effective.
+
+2. Dynamic Tool Introspection
+The agent doesnt have a static list of tools in its prompt anymore. Now:
+
+When starting, the MCP client asks the server what tools it offers.
+
+The agent dinamically injects the name, description, and JSON Schema of each tool into the system prompt.
+
+This allows the agent to learn how to use new tools instantly if you add them to the server, without touching the agent code.
+
+3. Verbose Log System (Debug Mode)
+I've added an advanced visualization for development. When running with the --verbose flag, the agent shows:
+
+Prompt Structure: The exact breakdown of what is sent to the LLM (Tools, Summary, Recent History, Observation).
+
+Consolidation: The real-time summary process and the resulting new context.
+
+JSON Formatting: Internal LLM messages formatted to be human-readable.
+
+New Tools Implemented
+Here are the tools i've added to the logic:
+
+inventory: It lists all the items you are currently carrying in your bag.
+
+get_map: Shows a list of every location visited so far, how many times you've been there, and highlights your current room.
+
+get_current_state: This is like a "status report". It gives you the score, moves, current observation, and the contents of the memory notebook all at once.
+
+![screenshot.png](screenshot.png)
+
+============================================================
+EXAMPLE OF VERBOSE MODE WITH MEMORY ROLL OUT
+============================================================
+
+                             ╭──────────────────────────────────────────────────────────────────────────────╮                             
+                             │                                                                              │                             
+                             │                                                                              │                             
+                             │                         ▄▀▀ ▄▀█ █▀▀ ▀█▀ █▀▄▀█ █▀▀ █▀█                        │                             
+                             │                         █▀  █▀█ ▄▄█  █  █ ▀ █ █▄▄ █▀▀                        │                             
+                             │                                                                              │                             
+                             │                                                                              │                             
+                             │                                FastMCP 2.14.4                                │                             
+                             │                            https://gofastmcp.com                             │                             
+                             │                                                                              │                             
+                             │                    🖥  Server:    Text Adventure Server                     │                             
+                             │                    🚀 Deploy free: https://fastmcp.cloud                     │                             
+                             │                                                                              │                             
+                             ╰──────────────────────────────────────────────────────────────────────────────╯                             
+
+[02/21/26 13:04:18] INFO  Starting MCP server 'Text Adventure Server' with transport 'stdio'
+
+Available tools: ['play_action', 'inventory', 'get_map', 'get_current_state']
+
+Initial observation:
+West of House
+You are standing in an open field west of a white house, with a boarded front door.
+There is a small mailbox here.
+
+────────────────────────────────────────
+Step 1: Initial Investigation
+────────────────────────────────────────
+THOUGHT: I should examine the mailbox to see if it contains any useful items.
+TOOL: play_action
+ARGS: {'action': 'examine mailbox'}
+RESULT: The small mailbox is closed.
+
+────────────────────────────────────────
+Step 2: Interaction
+────────────────────────────────────────
+THOUGHT: Since the mailbox is closed, I should try to open it to see if there are any clues inside.
+TOOL: play_action
+ARGS: {'action': 'open mailbox'}
+RESULT: Opening the small mailbox reveals a leaflet.
+
+────────────────────────────────────────
+Step 3: Reading Discovery
+────────────────────────────────────────
+THOUGHT: Since the mailbox contains a leaflet, I should examine it to see what information it provides.
+TOOL: play_action
+ARGS: {'action': 'examine leaflet'}
+RESULT: "WELCOME TO ZORK! ZORK is a game of adventure, danger, and low cunning..."
+
+────────────────────────────────────────
+Step 4: Environmental Scan
+────────────────────────────────────────
+THOUGHT: I need to understand the environment and find more ways to interact with the house.
+TOOL: play_action
+ARGS: {'action': 'look'}
+RESULT: West of House. You are standing in an open field west of a white house... 
+        The small mailbox contains: A leaflet
+
+## SUMMARIZING HISTORY... (Rolling Memory)
+    NEW SUMMARY:
+
+    Game started. You are standing in an open field west of a white house, with a boarded front door. There is a small mailbox here, which you examine to find a leaflet inside. The leaflet welcomes you to Zork, describing it as a game of adventure, danger, and low cunning. Opening the mailbox reveals a single leaflet.
+
+────────────────────────────────────────
+Step 5: Consolidation
+────────────────────────────────────────
+THOUGHT: The leaflet is the only item of interest right now. I'll keep it in mind for clues.
+TOOL: play_action
+ARGS: {'action': 'examine leaflet'}
+RESULT: "WELCOME TO ZORK!..."
+
 ## Files
 
 | File | Description |
@@ -57,3 +170,6 @@ python run_agent.py --agent . --game lostpig -v -n 20
 # Run evaluation
 python -m evaluation.evaluate -s . -g lostpig -t 3
 ```
+
+
+