haive.games.poker.debug
=======================

.. py:module:: haive.games.poker.debug

.. autoapi-nested-parse::

   Debugging utilities for the poker agent.

   This module provides tools for debugging, testing and analyzing the poker agent's
   performance, including:
   - Test harnesses for structured output validation
   - Decision validation and verification
   - Error analysis and reporting
   - Game state visualization



Classes
-------

.. autoapisummary::

   haive.games.poker.debug.DecisionAnalyzer
   haive.games.poker.debug.GameStatePrinter
   haive.games.poker.debug.StructuredOutputTester


Module Contents
---------------

.. py:class:: DecisionAnalyzer

   Analyze and validate player decisions for correctness.


   .. py:method:: validate_decision(decision, player, game_state)
      :staticmethod:


      Validate if a decision is legal and reasonable.



.. py:class:: GameStatePrinter

   Utility for visualizing poker game state during debugging.


   .. py:method:: print_game_state(state)
      :staticmethod:


      Print a human-readable version of the current game state.



.. py:class:: StructuredOutputTester(llm_runnable, input_values)

   Test harness for validating LLM structured output handling.

   Initialize the tester with an LLM runnable and test inputs.


   .. py:method:: print_report()

      Print a detailed report of the test results.



   .. py:method:: run_batch_test(iterations = 10)

      Run multiple tests and collect statistics.



   .. py:method:: run_test(retries = 3)

      Run a single test of the LLM runnable with retries.