add run logging and smart state polling

[Alex5418]

Summary

Addresses #10. Adds two features:

• JSONL run logger (mcp/run_logger.py) — records every tool call and AI decision to logs/run_<timestamp>.jsonl for post-run analysis
  and model comparison
• Smart state polling (_get_smart()) — waits up to 8s during enemy turns for an actionable state, reducing wasted tool calls and token
  consumption
• log_agent_decision tool — lets the AI record reasoning before key decisions

All changes are additive — no modifications to existing tool signatures or the C# mod.

Details

Run logging

Every _get and _post call is logged to a JSONL file with timestamp, action name, args, and result preview. A new log_agent_decision
MCP tool lets the AI explicitly record reasoning (e.g., "Combat turn 3: enemy intends Attack 11, playing Defend + Strike because...").

Smart polling

get_game_state now uses _get_smart() which detects Play Phase: False in combat states and polls (1s intervals, up to 8s) until the
state is actionable. This saved ~40% of redundant state calls in testing with both Claude and local models.

Test plan

• Start STS2 with mod, run MCP server, verify logs/ directory is created with JSONL file
• Play through a combat, confirm tool calls and decisions are logged
• Verify get_game_state waits during enemy turns and returns on player turn
• Confirm no behavior change for non-combat screens (map, shop, events)
  Closes Feature: Add run logging and smart state polling for combat turns #10

[Gennadiyev]

Thanks for the PR. I'm manually reviewing this one and it looks very promising.

Recently, another STS2 player reminded me about the existence of an instant mode, which skips the animation entirely. I'm re-thinking about the correct way to handle it instead now, as enabling the mode not only resolves the animation in combat, but also other intermediate states (e.g. events awaiting proceed). Would love your input on this.

Regarding the logging, while I still agree that actions should be properly logged, explicitly declaring a tool for this seems to be beyond the scope of STS2MCP. API Hooks are neat and definitely nice-to-have.

[Alex5418]

Thanks for the PR. I'm manually reviewing this one and it looks very promising.

Recently, another STS2 player reminded me about the existence of an instant mode, which skips the animation entirely. I'm re-thinking about the correct way to handle it instead now, as enabling the mode not only resolves the animation in combat, but also other intermediate states (e.g. events awaiting proceed). Would love your input on this.

Regarding the logging, while I still agree that actions should be properly logged, explicitly declaring a tool for this seems to be beyond the scope of STS2MCP. API Hooks are neat and definitely nice-to-have.

I have no idea that "instant mode" is a thing😂, I will look into it and see if any improvements can be made with that also I'll see if the log can be improved with better readbility

[Alex5418]

Thanks for the PR. I'm manually reviewing this one and it looks very promising.
Recently, another STS2 player reminded me about the existence of an instant mode, which skips the animation entirely. I'm re-thinking about the correct way to handle it instead now, as enabling the mode not only resolves the animation in combat, but also other intermediate states (e.g. events awaiting proceed). Would love your input on this.
Regarding the logging, while I still agree that actions should be properly logged, explicitly declaring a tool for this seems to be beyond the scope of STS2MCP. API Hooks are neat and definitely nice-to-have.

I have no idea that "instant mode" is a thing😂, I will look into it and see if any improvements can be made with that also I'll see if the log can be improved with better readbility

ok i see so there's a hidden game speed setting called "Instant"that can be unlocked through mod? yeah if it actually works i think it will definitely be better than the smart polling way. I'll test it our later and see how it goes. Also I agree with you that logging should be put on the agent.md instead of directly injected inside the MCP

[Gennadiyev]

Haha I was also told by another friend of mine about the instant mode xD

Glad it helped, and hope you enjoy the new version here <3